home *** CD-ROM | disk | FTP | other *** search
/ 3D GFX / 3D GFX.iso / amiutils / m_p / minimorph / minimorph.doc < prev    next >
Text File  |  1995-12-30  |  10KB  |  275 lines
  1.  
  2.  
  3.                MiniMorph v1.1d
  4.  
  5.  
  6.   by Philippe Banwarth 1993/94
  7.   based on VMorph version 2 beta by Lee Wilkie 1992/93 (mainly for user
  8.   interface)
  9.  
  10. This is the freeware version of MiniMorph. You may use and distribute it as
  11. long as you don't ask more than a small copy fee. You use it at your own risk.
  12.  
  13. It needs : ReqTools.library          ⌐ Nico Franτois
  14.        IFF.library    (v23 or more)    ⌐ Christian A. Weber
  15.  
  16.  
  17. About this document.
  18.   As my English is very poor, and as MiniMorph's user interface is inspired 
  19.   by VMorph's one much of this document is taken from VMorph's doc file.
  20.   (indicated by [] )
  21.  
  22.  
  23. What is  MiniMorph ?
  24.   MiniMorph is a program that will allow you to create smooth morphs/warps
  25.   between two different images over a period of frames to create an animation.
  26.   Actually it works only on greyscale pictures (16-256). It has been written
  27.   100% in assembler to be as fast as possible. For example morphing a 
  28.   320*256*256 picture takes less than 9 seconds on a standard A1200.
  29.  
  30. [
  31. What is morphing ?
  32.   Morphing is an effect whereby you take a source and destination image
  33.   and over a period of time you fade/'bend' the source image into the
  34.   destination.
  35.  
  36.  
  37. What is warping ?
  38.   Warping is very similar to morphing except that the destination image
  39.   is only used as a 'shape'. The source image is then warped to fit this 
  40.   shape. This process is twice as fast as morphing as only one image is
  41.   rendered per frame as opposed to two for morphing.
  42. ]
  43.  
  44. What's on the disk ? 
  45.    1) MiniMorph v1.1d
  46.    2) IFF an ReqTools libraries (with a script to install them).
  47.    2) Three IFF pictures for you to experiment with.
  48.    4) This documentation.
  49.  
  50.  
  51. What are  MiniMorph requirement ?
  52.    1) IFF and ReqTools libraries (supplied)
  53.    2) Kickstart 1.3+
  54.    3) As much ram as possible. At least (picture height * picture width * 4) 
  55.       bytes of fast ram + (picture height * picture width * 1.5) bytes of
  56.       chip ram + some more ram for IFFlib to work
  57.  
  58. [
  59. How does MiniMorph do it?
  60.   To create a morph/warp you need two images, a source and a destination.
  61.   These are loaded into the program and are overlayed with a grid. Where the
  62.   lines of the grid intersect is called a point. One point on one of the
  63.   grids has a 'sister' point on the other.
  64.   
  65.   What the user then does is position these points over specific parts of
  66.   each image that are common to both. For example, if you were morphing 
  67.   between two faces you would position some points around the nose on the
  68.   source grid to 'outline' it then you would place the same points around
  69.   the nose on the destination grid.
  70.   
  71.   What you are left with after editing is complete is two grids that define
  72.   the shape of the source and destination images.
  73.   
  74.   When rendering is finally started   MiniMorph   does the following for each
  75.   frame :
  76.   
  77.    1) Creates a 'frame' grid from the source and destination grids.
  78.       The shape of this is a mix of the source and destination grids
  79.       and depends on what frame is being rendered. Example :
  80.       
  81.        First frame        -      100% Source/000% Dest
  82.        Half way frame     -      050% Source/050% Dest
  83.        Last frame         -      000% Source/100% Dest
  84.  
  85.    2) Takes the image data from every square of the source grid and maps
  86.       it into the shape of the same square from the frame grid to form
  87.       image A. 
  88.  
  89.    3) Does the same with the destination grid to form image B
  90.  
  91.    4) Mixes images A+B depending on current frame as above. Example :
  92.  
  93.        First frame        -      100% image A/000% image B
  94.        Half way frame     -      050% image A/050% image B
  95.        Last frame         -      000% image A/100% image B
  96. ]
  97.  
  98.  
  99.     
  100. Using   MiniMorph :
  101.   Keys :
  102.     Space .................    Toggle between source and destination grids.
  103.     Cursor keys ........... Move the picture (if bigger then screen)
  104.     F1/F2/F3/F4............ Open/close one of the windows.
  105.  
  106.  
  107.   Edit window :  
  108.     Slider button ......... Set strength in attract/repulse mode.
  109.     Mode .................. Move/attract/repulse (it's faster for you to
  110.                   try than for me to explain).
  111.     Show moves ............ Display for each point the move from source 
  112.                   to destination position. Press space for
  113.                   normal display.
  114.     The big slider ........ Move the display window on the pictures.(if
  115.                   the picture is bigger than the screen (use
  116.                   the RESET gadget to change the picture size))
  117.     AddMiddlePnt/Add prop pnt : Used when adding a new row/column : In 
  118.                   middle mode it is created in the middle of 
  119.                   the old points. In proportionnal mode it
  120.                                   is created where you clicked.
  121.  
  122.  
  123.   Picture window :
  124.     Image load ............ Load a picture, it may be truncated to match
  125.                   the actual size. MiniMorph accept any IFF
  126.                   picture and translate it to grey scale if
  127.                   necessary. It don't take care of specials
  128.                   modes (EHB, HAM, HAM8) so the result may
  129.                   be strange.
  130.     Image clear ........... Clear the picture.
  131.     Grid load ............. Load a grid, it's scaled to the picture size.
  132.     Grid save ............. Save the grid.
  133.     Reset ................. Reset the both grids AND images size to the 
  134.                   value indicated.
  135.  
  136.   Render window :
  137.     # of frames ........... The total number of frames including the
  138.                   first one (i.e. the source image (both
  139.                   modes)) and the last one (i.e. the
  140.                   destination image (morph mode)). So
  141.                   should be at least 2.
  142.     From ..................    The first frame to be rendered. It is
  143.                   senseless to 'render' frame 1 except if
  144.                   you want it to be saved with MiniMorph's
  145.                   palette. Start at one (not zero)
  146.     To .................... The last frame to be rendered.
  147.     GO .................... Start the rendering. Press ESC to stop.
  148.     name .................. This is the save name. MiniMorph saves each
  149.                   frame separately. A % in the name will be
  150.                   replaced by the frame number (which is added
  151.                   to the end if none). NIL: means no saving.
  152.     # of grey ............. Allow you to choose the depth of the outputed
  153.                   pictures. Please note that this has NO
  154.                   effect on the processing speed NOR on the
  155.                   display (Which is always 16 colours so non
  156.                   AGA machine users can use MiniMorph).
  157.  
  158.   Misc window :
  159.     TaskPri    ...............    Set the task priority. Useful when you
  160.                   want the rendering to be done as a
  161.                   background task while you play a
  162.                   minigame for example (they use less than
  163.                   10% of a 7MHz 68000)
  164.  
  165.  
  166.  
  167.  
  168. Using the editing grid :
  169.  
  170.   Moving a grid point.
  171.     Click on the point with the left button to pick it up and release button
  172.     to drop it.
  173.   
  174.   Adding/Removing flags.
  175.     Up to 5 flags may be used to mark points (for example to compare their
  176.     position on each grids). To do this just click on the point with the RIGHT
  177.     button. 
  178.  
  179.   Adding a row to the grid.
  180.     Move the cursor to the very left edge of the SCREEN (which is not
  181.     necessary left edge of the picture) between the two grid lines where you
  182.     wish to add a row and click the right button. 
  183.    
  184.   Adding a column to the grid.
  185.    Move the cursor to the very top edge of the screen (same remark) between
  186.    the two grid lines where you wish to add a column and click the right
  187.    button.  
  188.   
  189.   Removing a column or a row.
  190.     Go to the opposite edge and click right mouse button. The removed
  191.     row/column is the one that is left/up.
  192.  
  193. [
  194. Things to remember when using  MiniMorph
  195.  
  196.   1) When choosing two images to morph between make sure they are
  197.      of similar composition i.e. if they are faces try to get two that
  198.      are roughly the same size, brightness and in similar positions
  199.      within the image. This will produce a better morph. Also cut out
  200.      both objects being morphed and paste them onto a neutral background.
  201.      
  202.   2) Avoid creating 'bad' squares when editing as these will cause
  203.      incorrect results. A bad square is defined as :
  204.  
  205.     Any point along any of its diagonals lying outsize the area
  206.     of the square itself. (confused!? - you will be!)
  207.     
  208.   3) Animation frame values start at one, so for a ten frame animation
  209.      set range from one to ten. 
  210.  
  211.   4) When producing a morph or warp animation the first frame
  212.      will be identical to the source image. It is good idea to set
  213.      the range start to two and use the source image as the first frame.
  214.  
  215.      When morphing the above is true for the last frame as this will be
  216.      the same as the destination image. So decrease range end by one and
  217.      use the destination image as the last frame. 
  218.     
  219.    5) When outlining an object try to make sure the edge of the object
  220.       is just inside the lines of the grid, this produces a smoother
  221.       edge during rendering. 
  222.  
  223.    6) The more detailed the grid the better the result.
  224.       (note - this does NOT (Wow!) slow down the rendering process)
  225. ]
  226.  
  227. NOTES :
  228.     Grids are rescaled while images are just truncated so the examples
  229.     grid/images will only work in PAL:LORES mode. If you have the 
  230.         registered version you may set the image size to 320*256 then click
  231.         on the RESET gadget.
  232.  
  233.     While rendering (and only while rendering) MiniMorph uses a low
  234.     to high sorted palette : system requesters may be difficult to
  235.     read so I decided to suppress them ( don't be afraid it's 
  236.     perfectly legal : Amigados assumes that you have clicked on
  237.     Cancel ). For example instead of "volume XXX is write protected"
  238.     (from DOS), you will get a requester "IFF error : can't write file"
  239.     (from MiniMorph).
  240.  
  241.     Rendering speed depend on the pictures colours !! The more dark
  242.     it is the more fastest it will be rendered. A totally white
  243.     picture is processed 7-8% faster than a totally black picture.
  244.     Seems strange isn't it ? :-)
  245.  
  246.  
  247. The complete version cost US$ 3 (three) (see the address in the program). I
  248. don't expect to make money, it's mainly to incite YOU to write me. So please
  249. send me bug reports, suggestions, postcard, etc...
  250.  
  251.  
  252.  
  253.  
  254. credits:
  255.         Lee Wilkie ............... Original ideas
  256.         Ross Halliday ............ Digitised pictures
  257.         Christian A. Weber
  258.         and Nico Franτois ........ Great libraries
  259.  
  260. history:
  261.  
  262.     1.0    :    first release
  263.  
  264.     1.1    :    256 grey scales
  265.             minor bugs added :-(
  266.  
  267.     1.1b    :    minor bugs fixes
  268.  
  269.     1.1c    :    screen mode requester (if WB 3.0+)
  270.  
  271.     1.1d    :    little speed optimisation in some case
  272.             added the middle/prop gadget
  273.             added flags
  274.  
  275.